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Embedding  fonts  in  MetaPost  output 

Troy  Henderson 

Abstract 

MetaPost  [1,  2,  3]  is  a  powerful  graphics  language 
(by  John  Hobby)  based  on  Donald  Knuth’s  METR- 
FONT  [4]  with  high  quality  PostScript  output.  An 
outstanding  feature  of  MetaPost  is  that  typeset 
fonts  in  the  output  graphics  are  consistent  with 
those  in  Tj^X-basecl  documents.  However,  Meta¬ 
Post  does  not  embed  these  fonts  inside  the  output 
PostScript  files.  This  article  addresses  a  specific 
technique  for  performing  such  an  embedding. 

1  Introduction 

MetaPost  is  one  of  the  most  elegant  means  for  gen¬ 
erating  high  quality  vector  graphics.  The  language 
itself  is  very  mathematical  in  nature  and  consists  of 
statements  that  draw  and  fill  paths  and  label  type¬ 
set  text.  The  very  name  itself  indicates  that  Meta¬ 
Post  is  a  language  that  generates  another  language, 
namely  PostScript.  With  PostScript  as  output,  the 
graphics  are  perfectly  scalable  to  any  arbitrary  res¬ 
olution.  John  Hobby,  its  author,  writes: 

“[MetaPost]  is  really  a  programming  lan¬ 
guage  for  generating  graphics,  especially  fig¬ 
ures  for  TJrjX  [5]  and  troff  documents.” 

This  quote  by  Hobby  indicates  that  MetaPost 
figures  are  not  only  intended  to  be  embedded  inside 
of  T)^X-based  documents  but  also  require  T)^X  to 
be  complete.  This  is  apparent  when  examining  the 
PostScript  containing  typeset  text  which  is  output 
by  MetaPost.  MetaPost  does  not  embed  the  fonts 
used  inside  of  the  output  files.  The  philosophy  for 
this  is  that  there  is  no  real  need  for  such  embedding 
if  the  figures  are  going  to  appear  inside  a  TJ)X  doc¬ 
ument  because  TjrpC  itself  will  embed  the  necessary 
fonts.  However,  as  with  any  programming  language, 
the  source  is  often  compiled  (and  viewed)  several 
times  before  the  user  completes  each  figure.  So,  at 
least  for  debugging  purposes,  self-contained  output 
is  often  desired.  That  is,  we  often  want  PostScript 
output  which  has  all  necessary  fonts  embedded. 

2  Embedding  the  fonts 

According  to  the  statement  above,  a  naive  approach 
to  performing  this  embedding  is  to  simply  include 
the  figure  inside  a  TgX-based  document,  run  T£)X, 
and  use  Dvips  to  generate  the  stand-alone  Post¬ 
Script  graphic.  These  steps  highlight  the  embedding 
process;  however,  several  details  must  be  addressed 
in  order  to  create  a  fully  functional  approach.  In 
particular,  in  order  to  embed  the  figure  into  a  TJlX 


document,  the  size  of  the  figure  must  first  be  deter¬ 
mined  so  that  the  paper  size  of  the  resulting  DVI 
document  is  correct.  If  the  paper  size  is  too  small, 
then  the  T)t]X— >Dvips  process  will  clip  the  figure. 
Determination  of  the  appropriate  paper  size  can  be 
done  either  during  or  after  the  MetaPost  process. 

To  make  this  concrete,  suppose  we  have  a  Meta¬ 
Post  file  foo.mp  with  the  contents: 

beginf ig(l) 

draw  commands 
endf ig; 
beginf ig(2) 

draw  commands 
endf ig; 

end 

The  Perl  script  mpstoeps,  available  from 

http : //ctan . org/t ex- archive/graphics/ 
metapost/ contrib/tools/mpstoeps/, 

can  automate  the  above  process,  mpstoeps  as¬ 
sumes  that  the  filename  of  each  figure  is  of  the 
form  foo_l.mps,  foo_2.mps,  ...  as  opposed  to 
the  canonical  foo.l,  foo.2,  ...  naming  scheme, 
mpstoeps  transforms  a  MetaPost  figure  into  a  stand¬ 
alone  EPS  in  a  method  explained  in  greater  detail 
in  Section  3.  Furthermore,  mpstoeps  tightens  the 
bounding  box  of  the  resulting  EPS  so  that  it  matches 
that  of  the  original  MetaPost  output. 

3  Nuts  and  bolts 

As  an  alternative  to  the  magical  mpstoeps,  we  may 
also  use  MetaPost  itself  to  determine  the  width  and 
height  of  the  paper  size  needed  to  include  the  figure 
in  a  T)^X  document.  As  a  first  step  in  accomplishing 
this  task,  we  place 

numeric  w,h; 

w  :=  xpart  urcorner  bbox  currentpicture 

-  xpart  llcorner  bbox  currentpicture; 
h  :=  ypart  urcorner  bbox  currentpicture 

-  ypart  llcorner  bbox  currentpicture; 

immediately  before  the  endfig  statement.  Once 
these  lengths  w  and  h.  are  determined,  we  continue 
by  identifying  a  good  basename  for  the  working  files. 

string  base; 

base : = j  obname& " _ " ^decimal ( char code )  ; 

We  now  begin  writing  an  external  DT)^X  file  which 
will  use  the  geometry  and  graphicx  packages. 

write  "\documentclass{article}"  to  base&" .tex" ; 
write  "\usepackage{geometryI"  to  base&".tex"; 
write  "\usepackage{graphicxl"  to  base&".tex"; 
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The  geometry  package  is  used  to  guarantee  that  the 
output  will  have  the  precise  geometry  (i.e.  paper 
size,  margins,  etc.)  needed. 

write  "\geometry{papersize={" 

&  decimalCceiling(w))  &  "bp," 

&  decimalCceiling(h))  &  "bp}-}" 
to  baseft" . tex" ; 

write  " \geometry{margin={Obp , Obp}} " 
to  baseft" . tex" ; 

write  "\geometry{noheadf oot ,nomarginpar}" 
to  baseft" . tex" ; 

Once  these  preliminaries  for  the  HTgX  document  are 
established,  we  then  insert  the  MetaPost  output  file 
and  complete  the  document. 

write  "\begin{document}"  to  base&" .tex"  ; 
write  "\thispagestyle{empty}"  to  base&" .tex" ; 
write  "\noindent\includegraphics{" 

&  jobname  &  &  decimal (charcode)  & 

to  baseft" . tex" ; 

write  "\end{document}"  to  base&".tex"; 
write  EOF  to  base&".tex"; 

Now  that  the  document  is  complete,  we  output  a  few 
messages  so  that  the  user  knows  the  precise  com¬ 
mands  to  execute  in  order  to  create  the  stand-alone 
EPS.  This  must  be  done  because  MetaPost  (for  se¬ 
curity  reasons)  will  not  call  external  commands. 

message  "================================" ; 

message  "Execute  these  commands  to  generate  " 

&  base&" . eps : " ; 

message  "latex  "  &  baseft  ".tex"; 

message  "dvips  -E  -T  "  &  decimal (ceiling(w) ) 

&  "bp,"  &  decimal (ceiling(h) ) 

&  "bp  -q  -o  "&base&".eps  "&base&" . dvi" ; 
message  "================================" ; 

message 

It  is  worth  noting  that  even  though  this  process  uses 
IM)5X,  the  MetaPost  process  itself  does  not  neces¬ 
sarily  use  IMJiX  to  process  the  text.  On  most  Meta¬ 
Post  installations,  the  default  processor  for  text  la¬ 
bels  is  plain  TJrpC.  Furthermore,  the  above  process 
for  embedding  fonts  usually  increases  the  bounding 
box  of  the  figure  by  at  least  1  bp  on  each  side,  un¬ 
like  mpstoeps(which  simply  preserves  the  original 
bounding  box). 

4  Typesetting  fonts  using 

As  previously  mentioned,  for  most  MetaPost  distri¬ 
butions,  the  default  processor  for  text  labels  is  plain 
TgX.  However,  some  users  find  it  convenient  to  use 
IAIJ^X  to  process  the  text.  For  example,  users 

are  accustomed  to  using  $\frac{aHb}$  to  create 


fractions;  this  command  (as  well  as  many  others)  is 
not  available  in  TJ^X.  A  typical  MetaPost  source  file 
bar .  mp  which  uses  HTJ^X  to  process  the  text  may  be 
organized  in  the  following  manner. 

verbatimtex 

\documentclass-famsart} 

\begin-f  document} 
etex 

beginf ig(l) 

draw  commands 
endf ig; 
beginf ig(2) 

draw  commands 
endf ig; 

end 

However,  this  format  for  bar.mp  alone  is  not  suffi¬ 
cient  to  force  to  process  the  text.  The  mpost 

command  must  also  be  instructed  to  use  IAQ^X. 
This  can  be  done  via 

mpost  -tex=latex  bar.mp. 

To  make  this  preference  the  default  under  teTJnjX, 
we  set  the  environment  variable  TEX=latex. 

5  Working  example 

We  now  illustrate  the  processes  mentioned  above  by 
applying  them  to  a  simple  MetaPost  figure.  We  will 
use  two  copies  of  the  figure  —  one  with  mpstoeps 
and  the  other  with  the  process  described  in  Sec¬ 
tion  3.  Both  figures  will  be  defined  in  a  MetaPost 
source  file  tri  .mp.1  In  order  to  use  HTJrjX  to  process 
the  text  labels,  we  preface  the  code  with: 

verbatimtex 

\document  class-fart  icle} 

\begin-[document} 

etex 

We  then  draw  the  figure  with  the  following  com¬ 
mands: 

picture  pict; 
beginf ig(l) 
u:=36; 

w:=fontsize  defaultfont; 

xl=u;x2=u*cosd(120) ; 
yl=0;y2=u*sind(120) ; 

draw  (xl ,yl) — (x2 ,y2) — (x2, -y2) — cycle ; 
label (btex  $a$  etex, (xl-w,yl) ) ; 
label . lft (btex  $A$  etex , (x2 ,yl) ) ; 
label (btex  $b$  etex, (x2-w*cosd(120) ,y2-w* 
sind(120) ) ) ; 

1  The  electronic  version  of  this  article  contains  tri  .mp  em¬ 
bedded  as  an  attachment  to  the  PDF. 
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label . lrt (btex  $B$  etex, ( (xl+x2) /2 ,-y2/2) ) ; 
label(btex  $c$  etex, ( (u-w) *cosd(120) , (-u+w) * 
sind(120) ) ) ; 

label .urt (btex  $C$  etex, ( (xl+x2) /2 ,y2/2) ) ; 
pict : =currentpicture ; 
endf ig; 

We  store  the  picture  into  pict  since  we  want  to  reuse 
it  in  the  next  figure.  We  then  “reload”  it  into  the 
next  figure  by 

beginf ig(2) 

currentpicture : =pict ; 

write  commands  from  Section  3 

message  commands  from  Section  3 

endf ig; 

Finally,  we  append  the  canonical  closing  statements 
for  MetaPost. 

end 

Once  tri.mp  is  compiled,  we  rename  tri .  1  to 
tri_l.mps  and  apply  mpstoeps.  This  provides 
the  stand-alone  EPS  tri_l.eps  with  all  fonts  em¬ 
bedded: 

mv  tri.l  tri_l.mps 
mpstoeps  tri_l.mps 

Furthermore,  we  are  also  instructed  to  execute 
latex  tri_2.tex 

dvips  -E  -T  69bp,67bp  -q  -o  tri_2.eps  tri_2.dvi 

After  following  these  steps,  we  obtain  tri_2.eps, 
which  is  virtually  identical  to  tri_l  .eps,  and  both 
of  these  EPS  files  have  their  fonts  embedded.  This 
mutual  figure  is  shown  below: 


6  Conclusion 

It  is  worth  mentioning  that  although  both  stand¬ 
alone  EPS  graphics  in  Section  5  look  virtually  iden¬ 
tical  to  the  original  MetaPost  output,  they  are  sig¬ 
nificantly  larger  in  file  size.  This  drastic  difference 
is  clearly  due  to  size  of  the  embedded  fonts. 

Also,  renaming  the  MetaPost  output  files  using 
the  .mps  naming  scheme  is  a  convenient  method  for 
using  either  or  pdflAQ^X  to  compile  the  docu¬ 

ment.  The  latter  does  not  allow  arbitrary  PostScript 
graphics,  but  does  support  MetaPost  output  —  as 
long  as  the  file  is  renamed  with  extension  .mps. 

As  a  final  note,  arbitrary  EPS  files  must  first  be 
converted  to  PDF  before  they  can  be  included  with 
pdfJATEX.  Thanks  to  Hans  Hagen,  many  distribu¬ 
tions  of  TJ^X  now  include  a  utility  called  mptopdf 
which  provides  a  method  of  easily  converting  such 
graphics  to  PDF. 
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